home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #5 & #6 / Amiga Plus CD - 1995 - No. 5 and 6.iso / pd / grafik / superviewel / superviewlibrary / docs / svsupport-docs / controlpad.doc next >
Text File  |  1995-08-02  |  4KB  |  90 lines
  1.  
  2.   The ControlPad-FileFormat V6.4 (2.4.95)
  3.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.   Many SVObjects, SVDrivers and SVOperators have to handle globally set
  5.   preferences, which might also have to be handled and/or modified by
  6.   custom programs or SuperViewPrefs.
  7.  
  8.   To prevent multiple different ways of storing these preferences
  9.   data, I introduced a common standard FileFormat for such configuration
  10.   files: The ControlPad-FileFormat
  11.   (please read the notes under "Style Guide" below).
  12.  
  13.    - To allow easy reading and understanding of these Files, these are
  14.      stored in plain ASCII
  15.    - To prevent people from learning just another technique of configuring
  16.      files, these are constructed just like a kind of "Tooltype-Lists"
  17.    - a single ControlPad takes a full line of the File
  18.      and looks like that : <Name>=<Content> or <Keyword>
  19.      Content and Name may contain any ASCII characters except "=", because
  20.      the first "=", which is found, is used to separate the Name from the
  21.      Content in the line. A Keyword is anything, which does not contain
  22.      a "=" somwhere, but is not a comment.
  23.    - So all other special characters are possible (although you should
  24.      not make too much use of them for ergonomical reasons).
  25.    - it is supported to write as much comments to the files, as wished.
  26.      A comment line has to begin with "/" or ";" in its first column.
  27.      A totally blank line fits to the same category as "/" or ";" lines.
  28.  
  29.  
  30.   Additional Notes
  31.   ~~~~~~~~~~~~~~~~
  32.   * Note, that comments are totally ignored by the Library functions, when
  33.     reading ControlPad-Files, and writing of comments is not supported.
  34.  
  35.     So do not add too much comments to your files, but on the other hand,
  36.     explain all of the Switches (and their default values) inside the
  37.     Doc-Files of your program to prevent a lack of information !
  38.  
  39.   * The SVSUP_FindControlPad() function is case-sensitive, so if nothing
  40.     else is specified, the ControlPad-entries are always also
  41.     case-sensitive. Case-Insensitive functions already have been added
  42.     (SVSUP_FindControlPadNoCase()) but are not used widely yet.
  43.  
  44.   "Style Guide"
  45.   ~~~~~~~~~~~~~
  46.   Common "style guide" rules (PLEASE NOTE) :
  47.  
  48.    - ControlPads should be located in "ENV:superview-library/"
  49.      and have the plain name of the SVDriver/SVObject/... plus
  50.      ".controlpad" as extension.
  51.      For Example a ControlPad for JPEG.svobject should be
  52.      named "ENV:superview-library/JPEG.controlpad".
  53.    - for boolean entries use <YES|NO> choices, not <TRUE/FALSE>
  54.      or just set single Keywords like "USE_..."
  55.    - use pregnant and verbose names for multiple-choices, like
  56.      <HUFF|LWZ|ENTROPY>, not <1|2|3>
  57.    - use short names and statements, not long and complicated ones :
  58.      "ColorDepth=24" instead of "Number_of_Colors=16.7_million"
  59.  
  60.  
  61.   Examples
  62.   ~~~~~~~~
  63.   In "Programmers/Example_Tools/ControlPad" you find some example
  64.   Source, which deals with ControlPads and should explain anything
  65.   you need to know about these.
  66.  
  67.   In addition to the supplied example Files there and to the SourceCode,
  68.   here are some examples of ControlPad-Files (---[...]--- marks the
  69.   beginning and the end: both lines are not part of the file):
  70.  
  71. ------------------------------ (1) JPEG.controlpad -------------------------
  72. /* Set the Input/Output ColorDepth for JPEG encoding/decoding (8/24) : */
  73. COLORDEPTH=8
  74.  
  75. /* Compress highly, but still with a good quality */
  76. QUANTIZATION=75
  77. ----------------------------------------------------------------------------
  78. ------------------------------ (2) LIBRARY.controlpad ----------------------
  79. // Set Default SVDriver
  80. DEFAULTSVDRIVER=AGA.svdriver
  81.  
  82. // Support any Datatypes
  83. ANYDATATYPES
  84. ----------------------------------------------------------------------------
  85. ------------------------------ (3) 24BitToHam.controlpad -------------------
  86. ; Set dithering mode
  87. DITHERMODE=HAM6_QUICK
  88. ----------------------------------------------------------------------------
  89.  
  90.